home *** CD-ROM | disk | FTP | other *** search
/ World of Sound / World of Sound.iso / utils / misc / macresourcer 1.0 / macresourcer.doc < prev    next >
Encoding:
Text File  |  1993-12-04  |  4.2 KB  |  127 lines
  1.   __  __            ____                                            _   ___  
  2.  |  \/  | __ _  ___|  _ \ ___  ___  ___  _   _ _ __ ___ ___ _ __   / | / _ \ 
  3.  | |\/| |/ _` |/ __| |_) / _ \/ __|/ _ \| | | | '__/ __/ _ \ '__|  | || | | |
  4.  | |  | | (_| | (__|  _ <  __/\__ \ (_) | |_| | | | (_|  __/ |     | || |_| |
  5.  |_|  |_|\__,_|\___|_| \_\___||___/\___/ \__,_|_|  \___\___|_|     |_(_)___/ 
  6.  
  7.                             © 1993 by Frank Würkner
  8.                               All Rights Reserved
  9.  
  10.  
  11. COPYRIGHT NOTE
  12. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  13. The program MacResourcer is copyrighted © 1993 by Frank Würkner.
  14. All rights reserved.
  15.  
  16. MacResourcer is FREEWARE.  This program may be freely distributed as long as
  17.   - the executable and documentation remain unchanged and
  18.     are included in the distribution
  19.   - No other charge is made than to cover time and copying costs
  20.  
  21.  
  22. DISCLAIMER
  23. ¯¯¯¯¯¯¯¯¯¯
  24. No warranties of any kind are made as to the functionality of this
  25. program. You are using it ENTIRE at your own risk.
  26.  
  27.  
  28. SYSTEM REQUIREMENTS
  29. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  30. To run MacResourcer you'll need OS2.0 or higher !!!
  31.  
  32.  
  33. QUICK OVERVIEW
  34. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  35. If you or one of your friends own a Macintosh®, you might know that nearly
  36. all data for programms are stored in a special format, called "resource".
  37. With MacResourcer you can play and extract two common sound resourcetypes
  38. used : "snd " and "SOUN". The programm also accepts other resource types
  39. and lets you save their rawdata.
  40.  
  41.  
  42. USAGE
  43. ¯¯¯¯¯
  44. MacResourcer only works in your CLI, so don't start it from your Workbench !
  45. Nearby MacResourcer is pure and can be made resident.
  46. It has the following template :
  47.      RESOURCEFILE/A,DIR/K,PAT=PATTERN/K,RATE/K/N,VOL/K/N,LOOP/K/N,
  48.      WAIT/K/N,LIST/S,PLAY/S,INFO/S,SAVEALL=ALL/S,NOID/S,RAW/S,MACSND/S
  49.  
  50. RESOURCEFILE/A
  51.      Obviously the resourcefile you want to process.
  52.      NOTE: The programm will also accept resourcefiles packed with
  53.            MacLha, and unpacked on the Amiga® side. Such files have
  54.            a 512 byte extra header.
  55.  
  56. DIR/K
  57.      Normally the 8SVX-sounds are extracted to the current directory.
  58.      With this option you can specify an alternate directory.
  59.  
  60. PAT=PATTERN/K
  61.      By default all files are extracted. Use a pattern if you only want to
  62.      extract some files (any standard AmigaDOS wildcard is supported).
  63.      Also read the text at the NOID switch to know about how the name
  64.      is structured.
  65.  
  66. RATE/K/N
  67.      The programm tries to detect the right sampling rate itself, but I
  68.      had no definition of the soundresource types by the hand. So if it
  69.      sounds weird you can override the default. Mac sounds are normally
  70.      sampled in 5K, 7K, 11K or 22K. 
  71.  
  72. VOL/K/N
  73.      The playback volume (by default 64 is used)
  74.  
  75. LOOP/K/N (meaningless without PLAY switch)
  76.      Number of times a sound is played (by default 1)
  77.      NOTE: You can't interrupt the programm while playing the sound,
  78.            so be carefull with values greater than 5.
  79.  
  80. WAIT/K/N (meaningless without PLAY switch)
  81.      Delay between two sounds in 1/10 seconds (by default 0),
  82.      e.g. a value of 10 would be one second :-).
  83.  
  84. LIST/S
  85.      Only list sounds, don't extract them.
  86.  
  87. PLAY/S
  88.      Play sounds, don't extract them.
  89.  
  90. INFO/S
  91.      Give extra informtion about the structure of the resource.
  92.  
  93. SAVEALL=ALL/S
  94.      By default only the sounds of the resource are extracted.
  95.      Useing this switch the programm will also save the data in
  96.      any other resourcetype found.
  97.  
  98. NOID/S
  99.      By the default the sounds of the resource get there ID number
  100.      appeded to there name. This is because the names of the resource
  101.      mustn't be unique (in fact there needn't be any name for them).
  102.      To suppress this use the NOID switch. For example a sound with the
  103.      name "Test" and the ID 243 would get the name "Test" rather than
  104.      the name "Test_Id243".
  105.  
  106. RAW/S
  107.      By default sounds are saved as 8SVX-sounds (iff-sounds). Use this
  108.      switch if you want raw sounds.
  109.  
  110. MACSND/S
  111.      Use this switch if you want the original data of the soundresource
  112.      elements, i.e. the MacSnd's.
  113.  
  114.  
  115.  
  116. If you have comments, suggestions, criticism, bug reports etc.
  117. send mail to
  118.  
  119.                 Frank Würkner
  120.                 Georgenschwaigstr. 22
  121.                 D-80807 München
  122.                 Germany
  123.  
  124.                 or
  125.  
  126.                 E-Mail: wuerkner@informatik.tu-muenchen.de
  127.